home *** CD-ROM | disk | FTP | other *** search
/ Experimental BBS Explossion 3 / Experimental BBS Explossion III.iso / compress / convr310.zip / BRUCE310.DOC next >
Text File  |  1993-10-16  |  15KB  |  339 lines
  1. BRUCE310.DOC
  2. 10/16/93
  3.  
  4. This documentation provides some overview information on a number of utilities
  5. that have been posted by Wayne Software.  All programs described herein were
  6. written by Bruce Guthrie.  Most are distributed with a Wayne Software copyright.
  7. Others were written for the U.S.  Department of Commerce.  All are free for use
  8. provided relevant documentation is kept with the programs, no changes are made
  9. to the programs or documentation, and they are not bundled with commercial
  10. programs or charged for separately.
  11.  
  12. CHANGE, CONVERT, FILUPDAT, FIXCHARS, and READ are excluded from the commercial
  13. packaging restriction.  These programs are owned by the U.S.  Department of
  14. Commerce and may be re-distributed without restriction.
  15.  
  16. People who need to bundle AV, BFIND, DIRCOMP, DIRTOTAL, FILL, MULTICOL, NETSORT,
  17. or READINIT in commercial packages other than shareware/freeware collections
  18. must pay a $50 registration fee to "Wayne Software" at the following address.
  19. READMAKE-created files are also subject to this limitation.  Comments and
  20. suggestions can also be sent to:
  21.  
  22.                 Bruce Guthrie
  23.                 Wayne Software
  24.                 113 Sheffield St.
  25.                 Silver Spring, MD 20910
  26.  
  27.                 fax: (301) 588-8986
  28.  
  29. Foreign users:  Please provide an Internet address in all correspondence.
  30.  
  31. The utilities are uploaded with a ZIP name that includes the year and month of
  32. the release.  These names are:
  33.  
  34.          AVymm.ZIP        (a) AV program
  35.                           (a) w/CONFIGWS
  36.          BFINDymm.ZIP     (a) BFIND program
  37.                           (a) w/CONFIGWS
  38.          CHANGymm.ZIP     (b) CHANGE program
  39.                           (a) w/CONFIGWS
  40.          CONVRymm.ZIP     (b) CONVERT program
  41.                           (a) w/CONFIGWS
  42.          DIRCOymm.ZIP     (a) DIRCOMP program
  43.          DIRTOymm.ZIP     (a) DIRTOTAL program
  44.                           (a) w/CONFIGWS
  45.          FILLymm.ZIP      (a) FILL program
  46.                           (a) w/CONFIGWS
  47.          FILUPymm.ZIP     (b) FILUPDAT program
  48.          FIXCHymm.ZIP     (b) FIXCHARS program
  49.          MULCOymm.ZIP     (a) MULTICOL program
  50.          NETSOymm.ZIP     (a) NETSORT program
  51.          READymm.ZIP      (b) READ program
  52.                           (a) w/CONFIGWS program
  53.                           (a) w/READINIT program
  54.                           (a) w/READMAKE program
  55.  
  56. Note:  "(a)" indicates owned by Wayne Software.  "(b)" indicates owned by U.S.
  57. Department of Commerce.
  58.  
  59.  
  60. This collection of utilities were compiled using Microsoft's VisualBASIC for DOS
  61. 1.0 compiler.  In each case, Thomas G.  Hanlin III's excellent PBClone routines,
  62. release 2.2, provided additional functionality.  Each of the utilities are
  63. separately described in a like-named *.DOC file.  This documentation
  64. (BRUCEymm.DOC--the file release date is indicated by the "ymm" parameter) serves
  65. to summarize what the various utilities consist of.
  66.  
  67. Several of the routines have defaults that can be changed by the program
  68. CONFIGWS.EXE which is included in the appropriate ZIP's.
  69.  
  70. Wayne Software also writes programs, batch files, and sets up menu systems for
  71. people on a for-fee basis.  If you desire this service, contact Wayne Software
  72. at the address specified above.
  73.  
  74.  
  75. --------------------------------------------------------------------------------
  76.  
  77. A summary of each routine follows.  See the associated *.DOC files for fuller
  78. explanations:
  79.  
  80. AV.EXE:  Archive directory viewer.  Presents list of files in archive (ZIP, ARC,
  81. etc) and lets you sort as desired.  Also allows resetting of the file date based
  82. on the archive's contents.  Syntax:
  83.  
  84.     AV filespec [ /-P | /P ] [ /Ox | /O-x ] [ /DATE ] [ /Q ] [ /? ]
  85.  
  86. BFIND.EXE:  Allows Boolean-type FIND requests.  For example, find any line with
  87. one string AND another one, or any line with one string OR another.  The syntax
  88. shown below is limited since "search" allows a lot of choices.
  89.  
  90.     BFIND [ /V | /-V ] [ /C | /-C ] [ /N | /-N ] [ /I | /-I ] [ /P | /-P ]
  91.       [ /-HEADER | /HEADER ] { search } infile [ /? ] [ >filename ]
  92.  
  93. CHANGE.EXE:  Processes change commands in files.  Files can be of any size and
  94. type (e.g.  binary or text) and are processed quickly.  Up to twenty-five change
  95. commands can be processed in a single pass.  Also provides ability to remove
  96. trailing spaces from text files.  Syntax:
  97.  
  98.     CHANGE filename [ commandfile | /FROM string /TO string [ /IN search ] ]
  99.       [ /LINES { line1-line2 | line1 linect } ... ] [ /V | /-V ] [ /I | /-I ]
  100.       [ /Noutfile [ /OVERWRITE | /-OVERWRITE | /OVERASK ] ]
  101.       [ /Fflag_file ] [ /Ttemp_file ] [ /TRIM | /-TRIM ]
  102.       [ /BINARY | /TEXT ] [ /VERIFY | /-VERIFY ] [ /Q ] [ /? ]
  103.  
  104. CONFIGWS.EXE:  Lets you change some of the defaults for some of the programs.
  105. Syntax:
  106.  
  107.     CONFIGWS [ routine ] [ /MONO | /-MONO | /COLOR | /-COLOR ] [ /? ]
  108.  
  109. CONVERT.EXE:  Converts between data formats:  FROM dBase, ASCII-delimited
  110. (commas between fields and quotes around strings), and fixed field TO Lotus WKS,
  111. ASCII-delimited, dBase, and fixed field.  Syntax:
  112.  
  113.     CONVERT infile [ outfile [ deffile ] ]
  114.       [ /OVERWRITE | /-OVERWRITE | /APPEND | /OVERASK ]
  115.       [ /DEF=deffile ] [ /FROM { FIXED | ASCII | ASCII=char | DBF } ]
  116.       [ /FIXED | /ASCII | /ASCII=char | /DBF ] [ /USEDEF | /NODEF ]
  117.       [ /TO { FIXED | ASCII | ASCII=char | WKS | DBF } ] [ /HEADER | /-HEADER ]
  118.       [ /SKIP | /MISSING | /ABORT ] [ /SAS ] [ /BEEP | /-BEEP ] [ /Q ] [ /? ]
  119.  
  120. DIRCOMP.EXE:  Similar in some ways to DOS's REPLACE command but adds ability to
  121. delete extra files in the destination subdirectory, copy hidden and system
  122. files, and prepare a report showing inconsistencies.  Syntax:
  123.  
  124.     DIRCOMP directory1 directory2 [ /ALL ] [ /UPDATE ] [ /KILL ]
  125.       [ /CLONE ] [ /ATTR=[H][S][R] ] [ /NET ] [ /Ffilename | /FNUL: | /SKIP ]
  126.       [ /OVERWRITE | /APPEND | /-OVERWRITE | /OVERASK ] [ /Q ] [ /? ]
  127.  
  128. DIRTOTAL.EXE:  Prepares report showing files in subdirectory or drive.  Allows
  129. some restriction requests (show only files with date greater than a certain
  130. value).  Similar to Norton's FF and Ray Van Tassle's WIZ command (which is a
  131. great program but it doesn't work on network or CD-ROM discs) in some ways but
  132. presents a more formal report.  Also allows you to look for duplicate file names
  133. and search by attributes or dates.  Syntax:
  134.  
  135.     DIRTOTAL [ [ drive: ] ... [drive:][filespec] |
  136.         [ drive: ] ... [drive:]\path[\filespec] ]
  137.       [ /NORMAL | /WIDE | /THIN | /SPLIT ] [ /DUPS ] [ /CHILD ]
  138.       [ /NL ] [ /S { GT | GT | LT | LE | EQ | NE } value ]
  139.       [ /D { GT | GT | LT | LE | EQ | NE } mm/dd/yy ]
  140.       [ /ATTR=attr ] [ /Ffilename ] [ /Z | /-Z ] [ /SUB | /-SUB ]
  141.       [ /Ox | /O-x ] [ /BEEP | /-BEEP ] [ /Q ] [ /? ]
  142.  
  143. FILL.EXE:  Program designed to fill up floppies with the maximum number of files
  144. that will fit into them.  "FILL *.BAS" will move *.BAS files onto a floppy,
  145. taking the biggest files first.  When it can't fit a file, it will skip it and
  146. move the next one.  Also provides option of splitting large files up.  Syntax:
  147.  
  148.     FILL [ source-filespec ] [ dest-drive: | dest-drive:\path\ ]
  149.       [ /MOVE | /COPY ] [ /PROMPT | /-PROMPT ]
  150.       [ /OVERWRITE | /-OVERWRITE | /OVERSKIP | /OVERASK ]
  151.       [ /Ox | /O-x ] [ /Xfilespec ]... [ /WIPE | /-WIPE ] [ /MULTI | /SINGLE ]
  152.       [ /SPLIT ] [ /BEEP | /-BEEP ] [ /Q ] [ /? ]
  153.  
  154. FILUPDAT.EXE:  Program which compares a selected list of files in a source path
  155. against those in another path and copies those that have been updated.  Similar
  156. to DOS' REPLACE command but works from a stored list of files and can handle any
  157. number of directories.  Syntax:
  158.  
  159.     FILUPDAT control_fil
  160.       [ /Flist_file [ /OVERWRITE | /APPEND | /-OVERWRITE | /OVERASK ] ]
  161.       [ /FULL ] [ /ALL ] [ /Q ] [ /? ]
  162.  
  163. FIXCHARS.EXE:  Program which removes non-standard print characters from a text
  164. file.  Translates graphics characters into their ASCII equivalents.  Also
  165. expands tabs and removes backspaces.  Is primarily intended for people who have
  166. problems printing a file.  Syntax:
  167.  
  168.     FIXCHARS infile { outfile [ /OVERWRITE | /-OVERWRITE | /OVERASK ] |
  169.       /REPLACE } [ /BINARY | /TEXT ] [ /Ffilename ] [ /-EJECT ] [ /Q ] [ /? ]
  170.  
  171. MULTICOL.EXE:  Program creates multiple column listings from straight ASCII
  172. text, ASCII-delimited text, or dBase files.  Also does subtotalling.  Syntax:
  173.  
  174.     MULTICOL infile outfile [ /OVERWRITE | /-OVERWRITE | /OVERASK ]
  175.       [ /DELIM="string" ]
  176.       [ /LINES=n ] [ /WIDTH=n ] [ /EJECT | /-EJECT ]
  177.       [ /COLUMNS=n ] [ /WRAP | /-WRAP [ /INDENT=n ] | /REFLOW ]
  178.       [ /Ccontrol_file ] [ /SETUP="string" ] [ /RESET="string" ]
  179.       [ /{ TITLE | HEADER | FOOTER }[ R | C | L ][ 1 to 5]="text" ]
  180.       [ /{ TITLE | HEADER | FOOTER }{ T | B }="string" ]
  181.       [ /FROM ASCII | /FROM ASCII=char | /FROM DBF ] [ /DEF=deffile ]
  182.       [ /SKIP | /MISSING | /ABORT ] [ /GAP=n ] [ /USEDEF ] [ /TALLY ]
  183.       [ /SUM={ col_spec | var_spec } ] [ /BREAK={ col_spec | var_spec } ]
  184.       [ /PRINT={ col_spec | var_spec } ] [ /? ]
  185.  
  186. NETSORT.EXE:  Slow but effective method for sorting files on a Banyan Vines (and
  187. possibly other) server.  Syntax:
  188.  
  189.     NETSORT [ path ] [ /S ] [ /Ox | /O-x ] [ /BEEP | /-BEEP ] [ /? ]
  190.  
  191. READ.EXE:  File browser.  Only works with files of 16,000 lines or less (maybe
  192. 800,000 bytes).  Other text viewers are out there.  This one has some advantage
  193. because it's free!  Syntax:
  194.  
  195.     READ [ filename ] [ /line ] [ /MONO | /-MONO | /COLOR | /-COLOR ]
  196.       [ /DOS | /-DOS ] [ /Pport ] [ /-I ] [ /? ]
  197.  
  198. READINIT.EXE:  Creates and maintains the READ.INI file which may be used by
  199. READ.EXE, READWK.EXE and any self-viewable file created by READMAKE.EXE.
  200. Syntax:
  201.  
  202.     READINIT [ /MONO | /-MONO | /COLOR | /-COLOR ] [ /-I ] [ /? ]
  203.  
  204. READMAKE.EXE:  Program which takes an ASCII-text file and makes it
  205. self-viewable.  Provides same capabilities as the READ program.  Syntax:
  206.  
  207.     READMAKE infile [ outfile ] [ /OVERWRITE | /-OVERWRITE | /OVERASK ]
  208.       [ /DATE=FILE | /DATE=TODAY ] [ /TITLE="text" ] [ /? ]
  209.  
  210. -------------------------------------------------------------------------------
  211.  
  212. If you can't get all of the utilities from your own sources, send $10 to the
  213. address above and I'll send you everything.  Please specify disk type.
  214.  
  215. Another Wayne Software product, called The DEMO System, is released as a
  216. shareware program.  The DEMO System is a unique system designed to create
  217. text-screen demos, tutorials, help screens, etc.  Look for the file
  218. DEMOSymm.ZIP.
  219.  
  220.  
  221. ================================Revision history================================
  222.  
  223. Detailed revision history is only maintained for the last two or three releases.
  224. After that, you get the major revision summaries only.  After six months or so,
  225. you get only earth-shattering stuff.  No one reads this junk anyway, right?
  226. Programmer types like to put in it in just to justify what they've been doing
  227. over the last couple of years.
  228.  
  229. --------------------------------------------------------------------------------
  230. Release 93/10:
  231.  
  232. CONCAT:  Dropped; no one ever asked about this program so what the hell.
  233.  
  234. CONVERT:  Fixed a problem with X records in the control file.
  235.  
  236. DIRTOTAL:  Fixed up a bug which dropped all output if /ATTR=H was specified.
  237. Also fixed up the other /ATTR restrictions.  Removed the 500 directory limit.
  238. Added /Td:, /NORMAL, /THIN, /-Z, /CHILD, and /DUPS options.  Sped up processing
  239. for most types of requests.
  240.  
  241. FILL:  Fixed a bug which ignored /COPY on large files if /SPLIT was used.
  242.  
  243. MULTICOL:  Fixed a problem with X records in the control file.
  244.  
  245. READ:  Fixed up a bug in some search operations.  Switched it so that / is a
  246. case-sensitive search; previously, all searches were case insensitive.
  247.  
  248. READWK:  Dropped due to lack of user response to it.  As it was, too many
  249. spreadsheets couldn't be viewed with it anyway.
  250.  
  251. --------------------------------------------------------------------------------
  252. Release 93/09:
  253.  
  254. SIMTEL archives were out of action so no release this month.  Versions are
  255. probably floating by with this release date but those releases should be
  256. considered "unofficial".
  257.  
  258. --------------------------------------------------------------------------------
  259. Release 93/08:
  260.  
  261. AV:  Increased the maximum number of members that could be sorted.  Officially,
  262. it was 1000 before but it choked around 200.  Now it can at least get to the
  263. large LZH file I have (770 members).  Added sorting options by by extension and
  264. compressed size.  Modified CONFIGWS to support these new options.  Sped up
  265. processing when resorting was required.  Fixed up bug which prevented you from
  266. changing back to an ascending sort once you selected a descending one.  Added
  267. /DATE and /Q toggles.
  268.  
  269. CONVERT:  Removed the restriction for ASCII-delimited files that character
  270. strings had to begin and end with quotation marks.
  271.  
  272. DIRCOMP:  It's back!  With some new options suggested by Jan Ornstedt from
  273. Sweden.  /CLONE, /ATTR=[R][H][S], and /SKIP.  Also enabled Escape handling.
  274.  
  275. DIRTOTAL:  Fixed a bug when it came to naming DIR files for CD-ROM and
  276. Bernoulli drives.
  277.  
  278. FILL:  Added a /SPLIT option which allows large files to be split across
  279. multiple diskettes.  Was a lot of work so I hope someone uses it!
  280.  
  281. MULTICOL:  Removed the restriction for ASCII-delimited files that character
  282. strings had to begin and end with quotation marks.
  283.  
  284. NETSORT:  Fixed a bug that caused negative percentages to show up once you went
  285. beyond about 30MB of files.
  286.  
  287. READWK:  Well!  That was embarassing!  Not being a spreadsheet user, I got all
  288. of my test worksheets off a compact disc that my office puts out--The National
  289. Economic, Social, and Environmental Data Bank.  I didn't realize that most
  290. spreadsheets don't have embedded ranges and the program apparently blows up on
  291. most spreadsheets!  Added a two-pass handler which detects the proper size of
  292. the spreadsheet and adjusts dimensions as appropriate.
  293.  
  294. --------------------------------------------------------------------------------
  295. Release 93/07:
  296.  
  297.   READ:  Added F9 (backward search for text).  Fixed a bug in READMAKE--
  298.   searching didn't work at all.
  299.  
  300. Release 93/06:
  301.  
  302.   DIRTOTAL:  Added /Ox, /O-x, and /WIDE options.
  303.  
  304.   READ:  Added /-DOS and /DOS options and made them CONFIGWS-able.
  305.  
  306. Release 93/05:
  307.  
  308.   New:  NETSORT and READWK.
  309.  
  310.   Dropped:  ADD, DIRCOMP, and TAKE1ST.  DIRCOMP returns in 93/08 version.
  311.  
  312. Release 93/03:
  313.  
  314.   New:  AV and READINIT
  315.  
  316. Release 93/01:
  317.  
  318.   First release posted on SIMTEL (Internet).
  319.  
  320.   New:  The DEMO System (shareware and not part of normal package).
  321.  
  322. Release 92/11:
  323.  
  324.   New:  MULTICOL and READMAKE.
  325.  
  326. Release BRUCE210.ZIP:
  327.  
  328.   New:  BFIND and CONFIGWS (called BGCONFIG then).
  329.  
  330. Release BRUCE208.ZIP:
  331.  
  332.   New:  FIXCHARS.
  333.  
  334. Release BRUCE204.ZIP:
  335.  
  336.   New:  ADD, CHANGE, CONCAT, CONVERT, DIRCOMP, DIRTOTAL, FILL, FILUPDAT, READ,
  337.   and TAKE1ST.
  338.  
  339.